Check out the Youtube video of the design process here
Have you ever had an issue of finding maps to play? well we are here to fix that by bridging the gap between anime and osu! Anisync is a web application that takes a MyAnimeList (MAL) username as input and returns a list of songs from the popular game osu! that appear on the user's anime list. As an osu! player myself, I always found it difficult to find maps to play when it was so tedious to search an anime one by one. For those who don't know, osu! is a popular rhythm game that has a large community of players. The game has a large library of songs to choose from and is constantly growing. The game is free to play and can be downloaded here.
Currently, a website for this program is deployed with the latest version being avaliable at: https://anisync.live
The program can also be run locally by following these steps. Please ensure you have pip installed on your machine. If you do not, please follow the instructions here.
- Clone this repository to your local machine:
git clone https://github.com/RajPandya737/Anisync.git- Change to the project directory:
cd Anisync- The project utilizes many libraries. Ensure you have all of them downloaded by running
pip install -r requirements.txt- Run the program, please read the usage part of this file before continuing:
python Anisync/app.pyOn the website, simply type in your MAL username into the search bar and click submit. The program will then take a few seconds to process the data and return a list of beatmaps that appear on your anime list. The beatmaps are sorted by the rating you gave on your list, and is limited to 300 beatmaps. If you have typed in your username correctly and no maps appear, it is likely due to the theme you have enabled on your anime profile, please disable it and try again.
If you are running it locally, make your way to http://localhost:8000 and follow the same steps as above.
The project consists of the following files inside of the Anisync Folder folder:
app.py: The main Python script.config.py: Contains all constants used in the program.data_processing.py: Stores all data retrival functions.db.py: Runs any database related functions, used to add data to the database.static/css: Contains CSS for each of the respective HTML files. The CSS is minified.static/images: Contains all images used in the project.static/js/about.js: Gives FAQ button functionality on about route.static/js/index.js: Corrects anime name mistakes due to the data_processing.py script on view-maps route.static/js/scroll.js: Sticky header functionality on view-maps route.templates: Contains all HTML files used in the project.translated_anime_list.sqlite: SQLite3 database that stores all anime data.wsgi.py: Used for deployment on Digital Ocean.
I will try to maintain this site and add new features when possible, however, with school and other commitments, I cannot guarantee that I will be able to. If you have any suggestions, feel free to let me know. As of right now, a few features I would like to add are:
- Anilist Support
- Top Anime ranked by MAL and their maps
- Sorting by categories other than user rating
- Multiple maps per anime
- MyAnimeList API: Currently used to get the anime image. Github and Documentation
- Osu! API: While I do not use this in the current state of the project, I initially did to aid in prototyping. Github and Documentation
- MAL Accounts Used for Testing and Data Gathering:
- Netflix: Much of the UI is inspired by Netflix's login page. Netflix Website
This project is licensed under the GNU Affero General Public License v3.0.